Danh sách phân tích thị trường

⚠️ Nên dùng API mới: Danh sách phân tích thị trường mới. signal dùng thuật ngữ giao dịch quốc tế (LONG/SHORT/SIDEWAYS) và bổ sung các trường như h24Summary, verdict.

Mô tả API

Truy vấn lịch sử phân tích thị trường AI theo token (BTC/ETH/SOL), hỗ trợ lọc theo khoảng thời gian.

Tình huống sử dụng:

• Truy vấn chính xác lịch sử phân tích thị trường theo token ID
• Lấy dữ liệu hàng loạt cho các tình huống như hiển thị biểu đồ
• Theo dõi tín hiệu tổng hợp AI và kết luận hỗ trợ/kháng cự của một token cụ thể

Tần suất cập nhật dữ liệu: mỗi 5 phút

signal biểu thị hướng được xác định trong chu kỳ phân tích 5 phút hiện tại. Mỗi chu kỳ trực tiếp trả về BUY, SELL hoặc HOLD. Nếu hướng giống chu kỳ trước, vẫn trả về giá trị enum cơ bản tương ứng; không sử dụng BUY_CONTINUE, SELL_CONTINUE hoặc HOLD_CONTINUE.

URL yêu cầu

• Phương thức: POST
• Đường dẫn: /open/v1/ai/getMarketAnalysisList

Credits

• Chi phí: 2

Điều kiện tiên quyết

Cần có vsTokenId, có thể lấy qua API danh sách token.

Tham số yêu cầu

Truyền tham số trong body dưới dạng JSON.

Tên tham số	Kiểu	Bắt buộc	Mô tả
vsTokenId	long	Có	Token ID
beginTime	string	Không	Thời gian bắt đầu (timestamp mili giây)
endTime	string	Không	Thời gian kết thúc (timestamp mili giây), mặc định là thời gian hiện tại nếu không truyền
limit	integer	Không	Số lượng trả về, mặc định 200, phạm vi 1-2000
language	string	Không	Ngôn ngữ, hỗ trợ zh-CN / zh-TW / en-US / vi-VN / ja-JP / ko-KR, mặc định zh-CN

Trường phản hồi

Chỉ liệt kê cấu trúc trường trong từng phần tử của mảng data:

Trường	Kiểu	Kiểu thực tế trả về	Mô tả
vsTokenId	long	string	Token ID
symbol	string	string	Ký hiệu token
icon	string	string	URL biểu tượng token
price	number	string	Giá tại thời điểm phân tích
signal	string	string	Tín hiệu tổng hợp AI trong chu kỳ phân tích 5 phút hiện tại: BUY (tăng giá) / SELL (giảm giá) / HOLD (sideway)
klineDiff	number	string	Biến động K-line dạng số thập phân, ví dụ -0.003 biểu thị -0.3%
supports	array	array<string>	Danh sách giá hỗ trợ (chuỗi giá)
resistances	array	array<string>	Danh sách giá kháng cự (chuỗi giá)
analysis	string	string	Kết luận phân tích AI theo ngôn ngữ yêu cầu
analysisTime	long	long	Thời gian phân tích (timestamp mili giây)
verdict	integer	integer	Xác minh tín hiệu: 0=chờ, 1=khớp, 2=không khớp
verdictDesc	string	string	Mô tả xác minh tín hiệu
h24Summary	object	object	Tổng hợp phân bố tín hiệu trong ngày tại thời điểm phân tích này (tính theo analysisTime của bản ghi)
buyCount	integer	integer	Số lần tăng giá
sellCount	integer	integer	Số lần giảm giá
holdCount	integer	integer	Số lần sideway
total	integer	integer	Tổng số lần
buyRatio	number	number	Tỷ lệ tăng giá (%, 1 chữ số thập phân)
sellRatio	number	number	Tỷ lệ giảm giá (%, 1 chữ số thập phân)
holdRatio	number	number	Tỷ lệ sideway (%, 1 chữ số thập phân)
conclusion	string	string	Kết luận tổng hợp trong ngày: OSCILLATE (sideway) / OSCILLATE_BULLISH (sideway thiên tăng) / OSCILLATE_BEARISH (sideway thiên giảm) / BULLISH (tăng giá) / BEARISH (giảm giá)

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa	Gợi ý sử dụng
vsTokenId	Định danh duy nhất của token	Tương ứng với tham số yêu cầu, dùng để kiểm tra quyền sở hữu dữ liệu
symbol	Ký hiệu giao dịch của token, ví dụ BTC, ETH	Dùng để hiển thị trên UI
icon	URL biểu tượng token	Dùng để render ở frontend
price	Giá token tại thời điểm bản phân tích này được phát hành	Kết hợp với analysis để hiểu bối cảnh giá
signal	Tín hiệu định hướng tổng hợp AI trong chu kỳ phân tích 5 phút hiện tại: BUY (tăng giá) / SELL (giảm giá) / HOLD (sideway); khi hướng tiếp tục, vẫn trả về giá trị cơ bản tương ứng	Nhanh chóng đánh giá xu hướng tổng thể của AI
klineDiff	Mức biến động K-line. Giá trị dương là tăng, giá trị âm là giảm	Kết hợp với signal để đánh giá động lượng giá
supports	Danh sách giá hỗ trợ quan trọng do AI tính toán	Theo dõi mức hỗ trợ gần nhất để hỗ trợ quyết định cắt lỗ
resistances	Danh sách giá kháng cự quan trọng do AI tính toán	Theo dõi mức kháng cự gần nhất để hỗ trợ quyết định chốt lời
analysis	Kết luận phân tích tổng hợp AI được trả về theo ngôn ngữ yêu cầu (string)	Hiển thị trực tiếp cho người dùng, không cần xử lý nhánh ngôn ngữ ở client
analysisTime	Timestamp của bản ghi phân tích	Dùng để sắp xếp và hiển thị theo thời gian
verdict	Kết quả xác minh tín hiệu AI so với biến động thực tế: 0 (chờ) / 1 (khớp) / 2 (không khớp)	Đánh giá độ chính xác lịch sử của tín hiệu AI
verdictDesc	Mô tả văn bản của kết quả xác minh	Hỗ trợ hiểu kết luận xác minh
h24Summary	Tổng hợp phân bố tín hiệu trong ngày nhìn lại từ analysisTime của bản ghi này	Số lần và tỷ lệ tăng/giảm/sideway trong cửa sổ thống kê; kết hợp conclusion để đánh giá xu hướng trong ngày

Ví dụ yêu cầu

{
    "vsTokenId": 1,                 // Token ID
    "beginTime": "1775732440000",   // Thời gian bắt đầu
    "endTime": "1775734240000",     // Thời gian kết thúc
    "limit": 200,                   // Số lượng trả về
    "language": "zh-CN"             // Ngôn ngữ (tùy chọn, mặc định zh-CN)
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/ai/getMarketAnalysisList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "beginTime": "1775732440000",
    "endTime": "1775734240000",
    "limit": 200,
    "language": "zh-CN"
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/ai/getMarketAnalysisList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"beginTime\": \"1775732440000\",    \"endTime\": \"1775734240000\",    \"limit\": 200,    \"language\": \"zh-CN\"}"

Ví dụ phản hồi thành công

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                            // Token ID
            "symbol": "BTC",                                             // Ký hiệu token
            "icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // URL biểu tượng token
            "price": "80573.75",                                         // Giá tại thời điểm phân tích
            "signal": "HOLD",                                            // Tín hiệu tổng hợp AI trong chu kỳ phân tích 5 phút hiện tại: BUY (tăng giá) / SELL (giảm giá) / HOLD (sideway)
            "klineDiff": "-0.00298373",                                  // Biến động K-line (số thập phân)
            "supports": ["80434.275", "79980.475"],                      // Danh sách giá hỗ trợ
            "resistances": ["80776.78", "81208.86"],                     // Danh sách giá kháng cự
            "analysis": "📊 BTC 日内主力资金趋势分析(ValueScan)...",     // Kết luận phân tích AI (ngôn ngữ hiện tại)
            "analysisTime": 1778837430000,                               // Thời gian phân tích
            "verdict": 0,                                                // Xác minh tín hiệu: 0=chờ
            "verdictDesc": "Chờ xác minh",                               // Mô tả xác minh tín hiệu
            "h24Summary": {                                              // Tổng hợp phân bố tín hiệu trong ngày tại thời điểm phân tích
                "buyCount": 12,                                          // Số lần tăng giá
                "sellCount": 5,                                          // Số lần giảm giá
                "holdCount": 7,                                          // Số lần sideway
                "total": 24,                                             // Tổng số lần
                "buyRatio": 50.0,                                        // Tỷ lệ tăng giá (%)
                "sellRatio": 20.8,                                       // Tỷ lệ giảm giá (%)
                "holdRatio": 29.2,                                       // Tỷ lệ sideway (%)
                "conclusion": "OSCILLATE_BULLISH"                        // Kết luận tổng hợp trong ngày: sideway thiên tăng
            }
        }
    ],
    "requestId": "2055219406232641536"
}